home *** CD-ROM | disk | FTP | other *** search
Text File | 1999-06-22 | 21.1 KB | 604 lines | [ TEXT/CWIE]
/******************** ***********************/ // // Player PRO 5.0 - DRIVER SOURCE CODE - // // Library Version 5.0 // // To use with MAD Library for Mac: Symantec, CodeWarrior and MPW // // Antoine ROSSET // 16 Tranchees // 1206 GENEVA // SWITZERLAND // // COPYRIGHT ANTOINE ROSSET 1996, 1997, 1998 // // Thank you for your interest in PlayerPRO ! // // FAX: (+41 22) 346 11 97 // PHONE: (+41 79) 203 74 62 // Internet: RossetAntoine@bluewin.ch // /******************** ***********************/ #ifndef __RDRIVERH__ #define __RDRIVERH__ #include "MAD.h" //////////////////////////////////////////////// #ifdef _MAC_H #ifndef __SOUND__ #include <Sound.h> #endif #ifndef __RETRACE__ #include <Retrace.h> #endif #endif //////////////////////////////////////////////// #ifdef _INTEL_H #ifndef __DSOUND_INCLUDED__ #include <mmreg.h> #include <DSound.h> #endif #endif //////////////////////////////////////////////// #if defined(powerc) || defined (__powerc) #pragma options align=mac68k #else #if !defined(THINK_C) #pragma options align=mac68k #endif #endif //////////////////////////////////////////////// /******************** ***********************/ /*** Define List ***/ /******************** ***********************/ #define NUMBER_NOTES 96 #define NOFINETUNE 8363 #define MIN_VOLUME 0 #define MAX_VOLUME 64 #define MAX_CHANVOL 128 #define MAX_PANNING 64 //#define MAXTRACK 32 //#define MAXINSTRU 64 #define MAXSAMPLE 64L #define MAXPATTERN 200 #define MAXPATTERNSIZE 900 #define MAX_ARP 3 #define MAXPLUG 40 /******************** ***********************/ /*** Error messages ***/ /******************** ***********************/ enum { MADNeedMemory = -1, MADReadingErr = -2, MADIncompatibleFile = -3, MADLibraryNotInitialized = -4, MADParametersErr = -5, MADUnknowErr = -6, MADSoundManagerErr = -7, MADOrderNotImplemented = -8, MADFileNotSupportedByThisPlug = -9, MADCannotFindPlug = -10, MADMusicHasNoDriver = -11, MADDriverHasNoMusic = -12 }; /******************** ***********************/ /*** Channel structure definition ***/ /******************** ***********************/ struct Channel { long ID; // Channel ID - 0 to MAXTRACK Ptr begPtr; // Sample Data Ptr - Beginning of data Ptr maxPtr; // Sample Data Ptr - End of data Ptr curPtr; // Sample Data Ptr - Current position long sizePtr; // Sample Size in bytes long amp; // Sample amplitude: 8 or 16 bits long loopBeg; // Loop Beginning long loopSize; // Loop Size long ins; // Current Instrument ID long insOld; // Previous Instrument ID played on this channel long samp; // Current Sample ID long fineTune; // Finetune long note; // Note long noteOld; // Previous note played on this channel long period; // Current period long periodOld; // Previous period played on this channel long vol; // Channel vol (0 to 64) long pann; // Channel pan (0 to 64) long cmd; // Command Byte arg; // Argument of command Byte volcmd; // Volume Command long arp[ MAX_ARP]; // Used for arpeggio command long arpindex; // Used for arpeggio command Boolean arpUse; char viboffset; // Used for vibrato command long vibdepth; // Used for vibrato command long vibrate; // Used for vibrato command long vibtype; // Used for vibrato command long slide; // Used for slideUp and slideDown command long pitchgoal; // Used for portamento command long pitchrate; // Used for portamento command long volumerate; // Used for slideVolume command long oldArg[ 16]; long oldVibrate; long oldVibdepth; Ptr samplePtr; // Used internaly by MADPlaySoundData & MADPlaySndHandle /**/ Boolean KeyOn; short a; short b; short p; long volEnv; long volFade; short aa; short bb; short pp; long pannEnv; long lAC; Ptr prevPtr; long lastWordL, curLastWordL; long lastWordR, curLastWordR; long curLevelL, curLevelR; Boolean LevelDirectionL, LevelDirectionR, RemoverWorking; long prevVol0; long prevVol1; /**/ Boolean GEffect; short GPat, GReader; /**/ Boolean stereo; Byte loopType; Boolean pingpong; long preOff; char preVal, preVal2; char preValR, preVal2R; short spreVal, spreVal2; short spreValR, spreVal2R; long TICKREMOVESIZE; Boolean PanningE8; short trig; short PatternLoopE6, PatternLoopE6Count, PatternLoopE6ID; }; typedef struct Channel Channel; /******************** ***********************/ /*** Music description - used in Import/Export filter ***/ /******************** ***********************/ struct MADMusic { MADSpec *header; // Music Header - See 'MAD.h' PatData *partition[ MAXPATTERN]; // Patterns InstrData *fid; // Instruments sData **sample; // Samples Boolean musicUnderModification; // Tell the driver to NOT access music data }; typedef struct MADMusic MADMusic; /******************** ***********************/ /*** Driver Settings definition ***/ /******************** ***********************/ enum { oldASCSoundDriver = 1, // MAC ONLY, // NOT SUPPORTED anymore oldAWACSoundDriver, // MAC ONLY // NOT SUPPORTED anymore MIDISoundDriver, // MAC ONLY SoundManagerDriver, // MAC ONLY You should use only SoundManagerDriver for full compatibility ! QK25SoundDriver, // MAC ONLY DigiDesignSoundDriver, // MAC ONLY BeOSSoundDriver, // BE ONLY when using with BeOS compatible systems ! - NOT FOR MAC DirectSound95NT, // WINDOWS 95/NT ONLY when using with PC compatible systems ! - NOT FOR MAC Wave95NT, // WINDOWS 95/NT ONLY when using with PC compatible systems ! - NOT FOR MAC NoHardwareDriver // NO HARDWARE CONNECTION, will not produce any sound }; enum { oldMonoOutPut = 1, // NOT SUPPORTED anymore oldStereoOutPut, // NOT SUPPORTED anymore DeluxeStereoOutPut, // USE THIS ONE ONLY !!!!!!!!!!!!!! PolyPhonic // Do NOT use it ! Standard hardware doesn't support it ! }; struct MADDriverSettings { short numChn; // Active tracks from 2 to 32, automatically setup when a new music is loaded short outPutBits; // 8 or 16 Bits unsigned long outPutRate; // Fixed number, by example : rate44khz, rate22050hz, rate22khz, rate11khz, rate11025hz short outPutMode; // Now, only DeluxeStereoOutPut is available ! short driverMode; // MIDISoundDriver, SoundManagerDriver, BeOSSoundDriver, DirectSound95NT or Wave95NT // Boolean antiAliasing; // NOT USED anymore Boolean repeatMusic; // If music finished, repeat it or stop. Boolean sysMemory; // Allocate memory in Application Heap (false) or in System Heap (true) // Boolean Interpolation; // NOT USED anymore // Boolean MicroDelay; // NOT USED anymore long MicroDelaySize; // Micro delay duration (in ms, max 1 sec = 1000 ms, min = 0 ms) Boolean surround; // Surround effect active? true/false Boolean Reverb; // Reverb effect active? true/false long ReverbSize; // Reverb delay duration (in ms, min = 25 ms, max 1 sec = 1000 ms) long ReverbStrength; // Reverb strength in % (0 <-> 70) Boolean TickRemover; // Remove volume/sample/loop ticks. long oversampling; // OverSampling value, 1 = normal; works ONLY on 64bits processor (PowerPC) }; typedef struct MADDriverSettings MADDriverSettings; /******************************************************************/ //******************* MUSICS IMPORT/EXPORT PLUGS *****************/ // // Protocol Version 2.3 // // To use with PlayerPRO for CodeWarrior // // Your main function have to be in this form: // OSErr main( OSType order, // Ptr AlienFileName, // MADMusic *MadFile, // PPInfoRec *info, // MADDriverSettings *DriverParam); // // Actual plug have to support these orders: // // order: 'TEST': check the AlienFile to see if your Plug really supports it. // order: 'IMPT': convert the AlienFile into a MADMusic. You have to allocate MADMusic. // order: 'INFO': Fill PPInfoRec structure. // order: 'EXPT': Convert the MADMusic into AlienFile. You have to create the AlienFile. // Don't delete the MADMusic Structure after conversion !! // // An IMPORT plug have to support these orders: 'TEST', 'IMPT', 'INFO' // An EXPORT plug have to support these orders: 'EXPT' // An IMPORT/EXPORT plug have to support these orders: 'TEST', 'IMPT', 'INFO', 'EXPT' // // About Resources: // // Your Plug should have: Creator: 'SNPL', Type: 'IMPL' - MAC ONLY // // Your Plug have to have these resources - MAC ONLY: // // - One segment CODE 1000 with 68k Code // - One segment PPCC 1000 with PPC Code (OPTIONAL: if PlayerPRO in PPC cannot find it, it will use the CODE 1000 resource) // - One STR# resource : // // 1 string: which kind of files your plug support (OSType value!!! 4 char) By example: 'STrk', '669 ', etc... // 2 string: what does your Plug: EXPL : only Export files, IMPL : only Import Files, EXIM : import AND export. // 3 string: string that will be used in Import and Export menu of PlayerPRO // 4 string: Copyright string of this plug. // /******************** ***********************/ struct PPInfoRec { char internalFileName[ 60]; char formatDescription[ 60]; long totalPatterns; long partitionLength; short totalTracks; short totalInstruments; OSType signature; long fileSize; }; typedef struct PPInfoRec PPInfoRec; /******************** ***********************/ /*** Informations about Plugs: ThePlug[] ***/ /******************** ***********************/ #ifdef _MAC_H struct PlugInfo { Handle IOPlug; // Plug CODE Str63 MenuName; // Plug name Str63 AuthorString; // Plug author FSSpec file; // Location of plug file char type[ 5]; // OSType of file support OSType mode; // Mode support : Import +/ Export Boolean hasPPCCode; // Is Plug FAT? }; typedef struct PlugInfo PlugInfo; #endif #ifdef _INTEL_H //#include "windows.h" typedef OSErr (*PLUGDLLFUNC) ( OSType , Ptr , MADMusic* , PPInfoRec *, MADDriverSettings *); struct PlugInfo { HANDLE hLibrary; PLUGDLLFUNC IOPlug; // Plug CODE char MenuName[ 65]; // Plug name char AuthorString[ 65]; // Plug author char file[ 255]; // Location of plug file char type[ 5]; // OSType of file support OSType mode; // Mode support : Import +/ Export }; typedef struct PlugInfo PlugInfo; #endif #ifdef _BE_H typedef OSErr (*MADPlug)( OSType order, Ptr AlienFileName, MADMusic *MadFile, PPInfoRec *info, MADDriverSettings *init); struct PlugInfo { image_id hLibrary; MADPlug IOPlug; // Plug CODE char MenuName[ 65]; // Plug name char AuthorString[ 65]; // Plug author char file[1024]; // Location of plug file char type[ 5]; // OSType of file support OSType mode; // Mode support : Import +/ Export }; typedef struct PlugInfo PlugInfo; #endif /******************** ***********************/ /*** Global structure : PlayerPRO variables ***/ /******************** ***********************/ struct MADLibrary { long IDType; // IDType = 'MADD' -- READ ONLY -- Boolean sysMemory; long mytab[ 12]; /** Plugs Import/Export variables **/ PlugInfo *ThePlug; // Pointers on plugs code & infos short TotalPlug; // no of Plugs in pointer ThePlug }; typedef struct MADLibrary MADLibrary; struct MADDriverRec { /**********************/ /** Public variables **/ /**********************/ MADDriverSettings DriverSettings; // Driver SetUp -- READ ONLY -- /** Current music in memory, loaded with RLoadMusic() by example **/ MADMusic *curMusic; // Current music played by this driver, it can be 0L !!! MADLibrary *lib; /** Drivers variables **/ Channel chan[ MAXTRACK]; // Current driver channels -- READ ONLY -- Boolean musicEnd; // Is music playing finished? -- READ ONLY -- short Tube[ MAXTRACK]; // Used in 'Tracks View' Window - View menu short PartitionReader; // Current position in pattern (0...999) short Pat; // Current ID Pattern, see 'Patterns list' short PL; // Current position in partition, see 'Partition list' long VolGlobal; // Global SOFTWARE volume (This is NOT Mac hardware volume!) from 0 to 64 short speed; // Current speed, see speed Effect short finespeed; // Current finespeed, see speed Effect short InstruTube[ MAXINSTRU]; // Used in 'Instrument View' Window - View menu short VExt; // External music speed, see 'Adaptators' window. 80 = normal short FreqExt; // External music pitch, see 'Adaptators' window. 80 = normal Boolean Reading; // Reading indicator Boolean Active[ MAXTRACK]; // Channel Active? #ifdef _MAC_H SndChannelPtr MusicChannelPP; // The SndChannelPtr to apply SndDoCommand, etc. #endif // ONLY available if you are using MAC SoundManager driver #ifdef _INTEL_H LPDIRECTSOUND lpDirectSound; // The LPDIRECTSOUND to apply & get informations, etc. LPDIRECTSOUNDBUFFER lpDirectSoundBuffer, lpSwSamp; // ONLY available if you are using Win95 DirectSound driver #endif Ptr OscilloWavePtr; // Contains actual sound wave of music, in char (8 bits) or in short (16 bits) long OscilloWaveSize; // Size of previous buffer /** Private variables - Not documented **/ /* DO NOT MODIFY OR USE these variables */ long BytesToRemoveAtEnd, MIN_PITCH, MAX_PITCH, MOD_MIN_PITCH, MOD_MAX_PITCH, ASCBUFFERReal; short smallcounter, trackDiv; long FREQBASE; short InstruActif[ MAXINSTRU]; Ptr SysHeapPtr, IntDataPtr; Boolean XMLinear, MODMode, JumpToNextPattern, endPattern, MADPlay; long ASCBUFFER; long BufSize; long VSYNC, BufCounter, BytesToGenerate; short vibrato_table[ 64]; short SendMIDIClockData; //gOutNodeRefNum, MIDIPortRefNum short InstuNoOld[ MAXTRACK]; short NoteOld[ MAXTRACK]; short VelocityOld[ MAXTRACK]; Boolean TrackLineReading[ MAXTRACK], wasReading; Ptr OverShoot; long *DASCBuffer; short *DASCBuffer8; long MDelay; long RDelay; Ptr ReverbPtr; short PatDelay; #ifdef _MAC_H SndDoubleBufferHeader TheHeader; #endif }; typedef struct MADDriverRec MADDriverRec; /******************** ***********************/ /*** EFFECTS ID ***/ /******************** ***********************/ enum { arpeggioE = 0, // 0x00 downslideE = 1, // 0x01 upslideE = 2, // 0x02 portamentoE = 3, // 0x03 vibratoE = 4, // 0x04 portaslideE = 5, // 0x05 vibratoslideE = 6, // 0x06 nothingE = 7, // 0x07 panningE = 8, // 0x08 offsetE = 9, // 0x09 slidevolE = 10, // 0x0A fastskipE = 11, // 0x0B volumeE = 12, // 0x0C skipE = 13, // 0x0D extendedE = 14, // 0x0E speedE = 15 // 0x0F }; /******************** ***********************/ /*** FUNCTIONS ***/ /******************** ***********************/ #ifdef __cplusplus extern "C" { #endif void MyDebugStr( short, char*, char*); // Internal Debugger function, NORMALLY it is never called, only when FATAL error // You NEED to provide this function, see examples! MADLibrary* MADGetMADLibraryPtr(); // Get MADDriver structure pointer. OSErr MADInitLibrary( char *PlugsFolderName, Boolean sysMemory, MADLibrary **MADLib); // Library initialisation, you have to CALL this function if you want to use other functions & variables OSErr MADDisposeLibrary( MADLibrary *MADLib); // Close Library, close music, close driver, free all memory void MADGetBestDriver( MADDriverSettings *DriverInitParam); // Found and identify the current Mac sound hardware and fill DriverInitParam OSErr MADCreateDriver( MADDriverSettings *DriverInitParam, MADLibrary *MADLib, MADDriverRec** returnDriver); // Music Driver initialization and memory allocation OSErr MADDisposeDriver( MADDriverRec *MDriver); // Dispose the music driver, use it after RInitMusic() OSErr MADChangeDriverSettings( MADDriverSettings *DriverInitParam, MADDriverRec** returnDriver); OSErr MADStartDriver( MADDriverRec *MDriver); // NEW - Activate the sound generating procedure (interruption) OSErr MADStopDriver( MADDriverRec *MDriver); // NEW - DESActivate the sound generating procedure (interruption) OSErr MADPlayMusic( MADDriverRec *MDriver); // NEW - Read and play current music in memory - Call MADStartInterruption BEFORE OSErr MADStopMusic( MADDriverRec *MDriver); // NEW - Stop reading current music in memory, Use MADCleanDriver to stop sounds void MADCleanDriver( MADDriverRec *intDriver); // Clean the driver : stop playing sounds OSErr MADReset( MADDriverRec *MDriver); // Reset the current music at the start position OSErr MADGetMusicStatus( MADDriverRec *MDriver, long *fullTime, long *curTime); // Get informations about music position and duration, IN 1/60th SECS !! NOT IN SECS ANYMORE !!!!!!! OSErr MADSetMusicStatus( MADDriverRec *MDriver, long minV, long maxV, long curV); // Change position of current music, by example MADSetMusicStatus( 0, 100, 50) = go to the middle of the music OSErr MADSetHardwareVolume( long); // 0...64, Mac HARDWARE volume, see MADDriver->VolGlobal for SOFTWARE volume long MADGetHardwareVolume( void); // Return HARDWARE volume, see MADDriver->VolGlobal for SOFTWARE volume OSErr MADAttachDriverToMusic( MADDriverRec *driver, MADMusic *music); OSErr MADLoadMusicRsrc( MADMusic **music, OSType IDName, short IDNo); // MAD ONLY - Load a MAD Rsrc into memory OSErr MADLoadMusicPtr( MADMusic **music, Ptr myPtr); // MAD ONLY - Load a MAD Ptr into memory, you can DisposPtr your Ptr after this call OSErr MADLoadMusicFilePString( MADLibrary *, MADMusic **music, char *type, Str255 fName); // Load a music file with plugs OSErr MADLoadMusicFileCString( MADLibrary *, MADMusic **music, char *type, Ptr fName); // Load a music file with plugs OSErr MADLoadMusicFSpFile( MADLibrary *, MADMusic **music, char *type, FSSpec *theSpec); // Load a music file with plugs OSErr MADMusicIdentifyPString( MADLibrary *, char *type, Str255 pName); // Identify what kind of music format is pName file. OSErr MADMusicIdentifyCString( MADLibrary *, char *type, Ptr cName); // Identify what kind of music format is cName file. OSErr MADMusicIdentifyFSp( MADLibrary *, char *type, FSSpec *theSpec); // Identify what kind of music format is theSpec file. Boolean MADPlugAvailable( MADLibrary *, char *type); // Is plug 'type' available? OSErr MADDisposeMusic( MADMusic **, MADDriverRec *MDriver); // Dispose the current music, use it after RLoadMusic(), RLoadMusicRsrc(), RInstallMADF() void MADChangeTracks( MADDriverRec *MDriver, short); // Change current tracks number of the music driver Cmd* GetMADCommand( short position, // Extract a Command from a PatData structure short channel, PatData* aPatData); OSErr MADPlaySndHandle( MADDriverRec *MDriver, Handle sound, // Handle to a 'snd ' handle, by ex: GetResource('snd ', 128); long chan, // channel ID on which to play sound long note); // note: 0 to NUMBER_NOTES or 0xFF: play sound at his normal sampleRate Khz OSErr MADPlaySoundData( MADDriverRec *MDriver, Ptr soundPtr, // Sound Pointer to data long size, // Sound size in bytes long channel, // channel ID on which to play sound long note, // note: 0 to NUMBER_NOTES or 0xFF: play sound at 22 Khz long amplitude, // 8 or 16 bits long loopBeg, // loop beginning long loopSize, // loop size in bytes unsigned long rate, // sample rate of the sound data, by ex: rate22khz Boolean stereo); // sample is in stereo or in mono? OSErr MADPlaySoundDataSYNC(MADDriverRec *MDriver, Ptr soundPtr, // Sound Pointer to data long size, // Sound size in bytes long channel, // channel ID on which to play sound long note, // note: 0 to NUMBER_NOTES or 0xFF: play sound at 22 Khz long amplitude, // 8 or 16 bits long loopBeg, // loop beginning long loopSize, // loop size in bytes unsigned long rate, // sample rate of the sound data, by ex: rate22khz Boolean stereo); // sample is in stereo or in mono? Ptr MADNewPtr( long size, MADLibrary* init); Ptr MADNewPtrClear( long size, MADLibrary* init); void MyDebugStr(short, Ptr, Ptr); // Called when a fatal error occurs.... Normally, NEVER ! #ifdef __cplusplus } #endif #if defined(powerc) || defined (__powerc) #pragma options align=reset #else #if !defined(THINK_C) #pragma options align=reset #endif #endif #endif 
